home *** CD-ROM | disk | FTP | other *** search
/ MacGames Sampler / PHT MacGames Bundle.iso / MacSource Folder / Samples from the CD / Assembly / Mac68k / MANUAL / MAN1.DOC next >
Encoding:
Text File  |  1985-08-20  |  7.4 KB  |  188 lines  |  [TEXT/Anon]
  1.  
  2.                                                                   MAC.68K
  3.  
  4.  
  5.  
  6.  
  7.                                MAC.68K
  8.                                MAC.68K
  9.                                MAC.68K
  10.  
  11.  
  12.  
  13.                        An  Absolute  Assembler
  14.  
  15.  
  16.  
  17.                            User's  Manual
  18.  
  19.  
  20.  
  21.  
  22.  
  23.                            Cyclan Software
  24.  
  25.  
  26.                            James  R  Hogue
  27.  
  28.  
  29.                          5316 Winter Moss Ct
  30.  
  31.  
  32.                          Columbia, MD  21045
  33.  
  34.  
  35.  
  36.  
  37.             Copyright  (c)  1985  by  James R Hogue.  All
  38.  
  39.  
  40.             rights reserved. No part of this  publication
  41.  
  42.  
  43.             may  be  reproduced  in  any form without the
  44.  
  45.  
  46.             prior written permission of James R Hogue.
  47.  
  48.  
  49.  
  50.  
  51.                              DISCLAIMER
  52.  
  53.  
  54.  
  55.        Cyclan Software makes  no  claims  or  warranties  with
  56.  
  57.  
  58.        respect   to   the   contents   or   accuracy  of  this
  59.  
  60.  
  61.        publication or the product it describes.  Further,  the
  62.  
  63.  
  64.        right  is  reserved  to  revise this publication and to
  65.  
  66.  
  67.        make changes from time to time in  the  content  hereof
  68.  
  69.  
  70.        without   obligation  to  notify  any  person  of  such
  71.  
  72.  
  73.        changes.
  74.  
  75.  
  76.  
  77.  
  78.                              TRADEMARKS
  79.  
  80.  
  81.  
  82.        CP/M-68K is a trademark of  Digital  Research.  MC68000
  83.  
  84.  
  85.        is  a registered trademark of Motorola Inc. MAC.68K and
  86.  
  87.  
  88.        LINK.68K are trademarks of Cyclan  Software.  Macintosh
  89.  
  90.  
  91.        is a trademark of Apple Computer.
  92.  
  93.  
  94.  
  95.  
  96.  
  97.  
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115. MAC.68K                                   -i-
  116.  
  117.  
  118.  
  119.                                                                   MAC.68K
  120.  
  121.  
  122.  
  123.                           TABLE OF CONTENTS
  124.                           TABLE OF CONTENTS
  125.  
  126.  
  127.  
  128.  
  129.  
  130.  
  131.        Section            Name                               Page
  132.  
  133.  
  134.  
  135.         I.     Invoking the Assembler                         2
  136.  
  137.  
  138.         II.    MAC.68K Language                               3
  139.  
  140.  
  141.                  1. Instruction fields                        3
  142.  
  143.  
  144.                  2. Continuation lines                        3
  145.  
  146.  
  147.                  3. Comment lines                             4
  148.  
  149.  
  150.                  4. Imbedded tab characters                   4
  151.  
  152.  
  153.                  5. Symbols                                   4
  154.  
  155.  
  156.                  6. Reserved symbols                          5
  157.  
  158.  
  159.                  7. Upper and lower case characters           5
  160.  
  161.  
  162.                  8. Names                                     5
  163.  
  164.  
  165.                  9. Concatenation or ghost characters         6
  166.  
  167.  
  168.                 10. Strings and string substitution           6
  169.  
  170.  
  171.                 11. ASCII control characters                  7
  172.  
  173.  
  174.                 12. Numeric data representation               7
  175.  
  176.  
  177.                 13. Character data representation             7
  178.  
  179.  
  180.                 14. Expression evaluation                     9
  181.  
  182.  
  183.         III.   Macros                                        10
  184.  
  185.  
  186.         V.     Program List Formats                          11
  187.  
  188.  
  189.         VI.    Program Structure                             11
  190.  
  191.  
  192.         VII.   File Names and Extensions                     13
  193.  
  194.  
  195.         VIII.  Resources Required                            14
  196.  
  197.  
  198.         IX.    Statistic and Error Messages                  15
  199.  
  200.  
  201.                  1. Command line errors                      15
  202.  
  203.  
  204.                  2. Initialization errors                    15
  205.  
  206.  
  207.                  3. Pass one messages                        16
  208.  
  209.  
  210.                  4. Pass two messages                        16
  211.  
  212.  
  213.                  5. Source line error flags                  17
  214.  
  215.  
  216.                  6. Completion messages                      18
  217.  
  218.  
  219.        X.     Pseudo Operations                              19
  220.  
  221.  
  222.  
  223.  
  224.                  APPENDICIES
  225.  
  226.  
  227.  
  228.         A.    Source Line Error Code Descriptions            66
  229.  
  230.  
  231.         B.    Supplemental Reading                           68
  232.  
  233.  
  234.  
  235.  
  236.  
  237.  
  238.  
  239.  
  240.  
  241.  
  242.  
  243.  
  244.  
  245.  
  246.  
  247.  
  248.  
  249.  
  250.  
  251. MAC.68K                                  -ii-
  252.  
  253.  
  254.  
  255.                                PSEUDO OPS                               CONTENTS
  256.  
  257.  
  258.  
  259.   Page    Name           Description
  260.  
  261.  
  262.  
  263.    21     BSS            Change to block storage segment.
  264.  
  265.  
  266.    22     DATA           Change to data segment.
  267.  
  268.  
  269.    23     DC             Generate data.
  270.  
  271.  
  272.    24     DEFER          Defer assembly of following lines.
  273.  
  274.  
  275.    25     DS             Reserve storage locations.
  276.  
  277.  
  278.    26     DUP            Duplicate the following lines.
  279.  
  280.  
  281.    27     ECHO           Duplicate lines with parameter substitution.
  282.  
  283.  
  284.    28     ELSE           Reverse the effects of an IF test.
  285.  
  286.  
  287.    29     END            Required last card in program.
  288.  
  289.  
  290.    29     ENDC           Terminate an IF block.
  291.  
  292.  
  293.    30     ENDD           Terminate a duplication block.
  294.  
  295.  
  296.    30     ENDM           Terminate a macro defintion.
  297.  
  298.  
  299.    31     ENTRY          Declare module entry points.
  300.  
  301.  
  302.    32     EQU or =       Define a symbol.
  303.  
  304.  
  305.    33     ERRxx          Conditionally force an assembly error.
  306.  
  307.  
  308.    33     EVEN           Force location counter to even word boundary.
  309.  
  310.  
  311.    34     GLOBL          Declare a global symbol(s).
  312.  
  313.  
  314.    35     HERE           Assemble DEFERed text lines
  315.  
  316.  
  317.    36     IDENT          Optional first card in program.
  318.  
  319.  
  320.    37     IF             Conditional assembly based on attribute.
  321.  
  322.  
  323.    38     IFS/IFC        Conditional assembly based on string comparisons.
  324.  
  325.  
  326.    39     IFxx           Conditional assembly based on expression comparisons.
  327.  
  328.  
  329.    40     INCLUDE        Include a text file.
  330.  
  331.  
  332.    42     INCLUDEH       Include a preassembled module.
  333.  
  334.  
  335.    42     INCLUDES       Include a preassembled symbol/macro definition file.
  336.  
  337.  
  338.    43     LIST           Control output listing.
  339.  
  340.  
  341.    44     LOC            Reset location counter.
  342.  
  343.  
  344.    45     LOCAL          Declare names local to a macro.
  345.  
  346.  
  347.    46     MACRO          Define a macro.
  348.  
  349.  
  350.    47     MACROL         Define a macro using location field as a parameter.
  351.  
  352.  
  353.    48     MAX            Assign symbol maximum value of listed expressions.
  354.  
  355.  
  356.    48     MIN            Assign symbol minimum value of listed expressions.
  357.  
  358.  
  359.    49     MODULE         Declare object file to be a module.
  360.  
  361.  
  362.    50     NOREF          Turn off reference attribute for symbol(s).
  363.  
  364.  
  365.    50     OFFSET         Change to a null storage segment.
  366.  
  367.  
  368.    51     OPSYN          Declare a synonymous macro/operation name.
  369.  
  370.  
  371.    52     OPTION         Enable/disable various run time options.
  372.  
  373.  
  374.    54     ORG            Reset origin counter.
  375.  
  376.  
  377.    55     PAGE           Force a page break or set page length/width.
  378.  
  379.  
  380.    55     PURGE          Delete a macro/operation name.
  381.  
  382.  
  383.    56     QUAL           Declare a symbol qualifier.
  384.  
  385.  
  386.    57     SECTION        Change segments.
  387.  
  388.  
  389.    58     SET            Change value of a redefinable symbol.
  390.  
  391.  
  392.    59     SPACE          Skip print lines.
  393.  
  394.  
  395.    60     STEXT          Declare a macro/symbol table assembly.
  396.  
  397.  
  398.    60     STOPDUP        Force early termination of DUP or ECHO.
  399.  
  400.  
  401.    61     STRDEC         Create a string from a decimal value.
  402.  
  403.  
  404.    61     STRHEX         Create a string from a hex value.
  405.  
  406.  
  407.    62     STRING         Define a character string.
  408.  
  409.  
  410.    63     STRLEN         Assign symbol the length of a string.
  411.  
  412.  
  413.    64     SUBTTL         Set listing subtitle.
  414.  
  415.  
  416.    64     TEXT           Change to the text segment.
  417.  
  418.  
  419.    64     TITLE          Set listing title.
  420.  
  421.  
  422.    65     VFD            Bit width data field.
  423.  
  424.  
  425.  
  426.  
  427.  
  428. MAC.68K                                  -iii-
  429.  
  430.  
  431. et listing title.
  432.  
  433.  
  434.    65     VFD